home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 2: Applications / Linux Cubed Series 2 - Applications.iso / editors / emacs / xemacs / xemacs-1.006 / xemacs-1 / lib / xemacs-19.13 / info / w3.info-1 < prev    next >
Encoding:
GNU Info File  |  1995-09-01  |  45.8 KB  |  1,098 lines
  1. This is Info file ../info/w3.info, produced by Makeinfo-1.63 from the
  2. input file w3.texi.
  3.  
  4.    This file documents the Emacs-w3 World Wide Web browser.
  5.  
  6.    Copyright (C) 1993, 1994, 1995 William M. Perry
  7.  
  8.    Permission is granted to make and distribute verbatim copies of this
  9. manual provided the copyright notice and this permission notice are
  10. preserved on all copies.
  11.  
  12. 
  13. File: w3.info,  Node: Top,  Next: Introduction,  Up: (DIR)
  14.  
  15.    This manual documents the Emacs-w3 World Wide Web browser, a Lisp
  16. program which runs as a subsystem under Emacs.  The manual is divided
  17. into the following chapters.
  18.  
  19. * Menu:
  20.  
  21. * Introduction::                What exactly is Emacs-w3?
  22. * Setting Up::                  How to set up and install Emacs-w3.
  23. * Basic Usage::                 Basic movement and usage of Emacs-w3.
  24. * Compatibility::               Explanation of how Emacs-w3 is compatible
  25.                                 with Mosaic/X and/or Netscape/X
  26. * Controlling Formatting::    How to control how Emacs-w3 formats HTML
  27. * HTTP/1.0 Support::        A detailed explanation of the HTTP/1.0
  28.                 and MIME support in Emacs-w3.
  29. * Security::                    Various forms of security in Emacs-w3.
  30. * Non-Unix Operating Systems::    Special considerations necessary to get
  31.                                 Emacs-w3 to run correctly under non-unix
  32.                                 OS's.
  33. * Advanced Features::           Some of the more arcane features.
  34. * More Help::                   How to get more help--mailing lists,
  35.                                 newsgroups, etc.
  36. * Future Directions::           What is planned for future revisions
  37.                                 of Emacs-w3
  38. * Programming Interface::       How to use emacs-w3 from other emacs
  39.                                 programs.
  40.  
  41. Indices:
  42. * Concept Index::               Concept Index
  43. * Key Index::                   Menus of command keys and their references
  44. * Command Index::               Menus of commands and their references
  45. * Variable Index::              Menus of variables and their references
  46.  
  47. 
  48. File: w3.info,  Node: Introduction,  Next: Setting Up,  Prev: Top,  Up: Top
  49.  
  50. Introduction
  51. ************
  52.  
  53.    Emacs-w3 is an Emacs subsystem that allows the user to browse the
  54. wonderful World Wide Web.
  55.  
  56.    The World Wide Web was started at the CERN physics institute in
  57. Switzerland in 1991.  The project was initially started by Tim
  58. Berners-Lee (timbl@w3.org) for distributing data between different
  59. research groups effectively.
  60.  
  61.    The Web has since grown into the most advanced information system
  62. currently on the internet.  It is now a global hypertext system with
  63. servers and "browsers" (programs written to interpret the hypertext
  64. language and display it correctly, and allow the user to follow links)
  65. exist for all major platforms (VMS, Windows, DOS, Unix, VM, NeXTstep,
  66. Amiga, and Macintosh).
  67.  
  68.    The basic concepts used in the Web are hypertext and hypermedia.
  69. Hypertext is the same as regular text, with one exception--it can
  70. contain links (cross-references) to other textual documents.  Hypermedia
  71. is slightly different--it can contain links to other forms of media
  72. (movies, sounds, interactive programs, etc.).
  73.  
  74.    WWW also allows searches of indices that are located anywhere on the
  75. network; in this respect, it mirrors certain capabilities found in both
  76. WAIS and Gopher.
  77.  
  78.                             ---------------
  79.  
  80.                            CLIENT SIDE VIEW
  81.  
  82.                             ---------------
  83.  
  84.    The WWW world consists of documents and links.  Indexes are special
  85. documents which, rather than being read, may be searched.  The result of
  86. such a search is another virtual document containing links to the
  87. documents found.  A simple protocol, HTTP is used to allow a browser
  88. program to request a keyword search by a remote information server.
  89.  
  90.    The web contains documents in many formats.  Those documents which
  91. are hypertext, (real or virtual) contain links to other documents, or
  92. places within documents.  All documents, whether real, virtual or
  93. indexes, look similar to the reader and are contained within the same
  94. addressing scheme.
  95.  
  96.                        ------------------------
  97.  
  98.                        INFORMATION PROVIDER VIEW
  99.  
  100.                        ------------------------
  101.  
  102.    WWW browsers can access many existing data systems via existing
  103. protocols (FTP, NNTP) or via HTTP and a gateway.  In this way, the
  104. critical mass of data is quickly exceeded, and the increasing use of the
  105. system by readers and information suppliers encourage each other.
  106.  
  107.    Providing information is as simple as running the WWW server and
  108. pointing it at an existing directory structure.  The server
  109. automatically generates the a hypertext view of the files to guide the
  110. user around.
  111.  
  112.    To personalize it, a few SGML hypertext files can be written to give
  113. an even more friendly view.  Also, any file available by anonymous FTP,
  114. or any internet newsgroup can be immediately linked into the web.  The
  115. very small start-up effort is designed to allow small contributions.  At
  116. the other end of the scale, large information providers may provide an
  117. HTTP server with full text or keyword indexing.  This may allow access
  118. to a large existing database without changing the way that database is
  119. managed.  Such gateways have already been made into Oracle(tm), WAIS,
  120. and Digital's VMS/Help systems, to name but a few.
  121.  
  122.    The WWW model gets over the frustrating incompatibilities of data
  123. format between suppliers and reader by allowing negotiation of format
  124. between a smart browser and a smart server.  This should provide a
  125. basis for extension into multimedia, and allow those who share
  126. application standards to make full use of them across the web.
  127.  
  128.    Here is some more specific information about what Emacs-w3 does and
  129. does not understand:
  130.  
  131. * Menu:
  132.  
  133. * Markup Languages Supported::    The different markup languages that
  134.                 Emacs-w3 understands natively.
  135. * Supported Protocols::        The different network protocols that
  136.                 Emacs-w3 speaks to.
  137.  
  138. 
  139. File: w3.info,  Node: Markup Languages Supported,  Next: Supported Protocols,  Prev: Introduction,  Up: Introduction
  140.  
  141. Supported Markup Languages
  142. **************************
  143.  
  144.    Several different markup languages, and various extensions to those
  145. languages, are supported by Emacs-w3.
  146.  
  147.                                ---------
  148.  
  149.                                HTML 2.0
  150.  
  151.                                ---------
  152.  
  153.    HTML is composed of a set of elements that define a document and
  154. guide its display.  An HTML element may include a name, some attributes
  155. and some text or hypertext, and appears in an HTML document as
  156. <tag_name>text</tag_name>, <tag_name
  157. attribute_name=argument>text</tag_name>, or just <tag_name>.
  158.  
  159.    For example: `<title> My Useful Document </title>', and `<pre
  160. width=60> A lot of text here.  </pre>'.
  161.  
  162.    An HTML document is composed of a single element: <html>...</html>,
  163. that is, in turn, composed of head and body elements: <head>...</head>,
  164. and <body>...</body>.  To allow older HTML documents to remain readable,
  165. <html>, <head>, and <body> are actually optional within HTML documents.
  166.  
  167.    All the tags and attributes of HTML are fully supported in Emacs-w3.
  168.  
  169.    The full HTML 2.0 specification is available via the web at
  170. http://www.hal.com/users/connolly/html-spec/HTML_TOC.html, or via
  171. anonymous ftp to www.ics.uci.edu:/pub/ietf/html/.
  172.  
  173.                                ---------
  174.  
  175.                                HTML 3.0
  176.  
  177.                                ---------
  178.  
  179.    The HTML 3.0 language is an extension of HTML, with a large degree of
  180. backwards compatibility with HTML 2.0.  The latest revision of HTML 3.0
  181. can be retrieved via anonymous ftp to ftp.w3.org, the file is
  182. /www/arena/html3-dtd.txt.  The following HTML 3.0 language elements are
  183. supported by Emacs-w3:
  184.  
  185.    * ID tags for headers and paragraphs.  This makes it possible to
  186.      reference points within a document and not require empty hypertext
  187.      links to do it.
  188.  
  189.    * Named BASE tags.  Base tags allow you to specify how relative links
  190.      within a document should be resolved (typically with a different
  191.      URL than that which was used to retrieve the file).  This is
  192.      useful if you want to store the file on disk, but still have the
  193.      links work correctly.
  194.  
  195.      HTML 3.0 extends the power of the BASE tag by allowing multiple
  196.      BASE tags in a single document, each with a NAME or ID attribute.
  197.      Any other tag required either the HREF or SRC attribute can also
  198.      have the BASE attribute.  If this matches the NAME/ID of a BASE
  199.      tag, then that URL is used as the basis for resolving the relative
  200.      link.  If no base tag matches the, a base tag with no NAME/ID is
  201.      used.  If no such base tag exists, the URL of the document is
  202.      used.
  203.  
  204.    * Text alignment.  Most tags that cause a line break (BR, H?, P,
  205.      etc) can now take an optional ALIGN attribute, which specifies how
  206.      the text enclosed within it is to be aligned.  Valid alignments
  207.      are:
  208.     left
  209.           The default alignment, causes text to be flush left, with a
  210.           ragged right edge.
  211.  
  212.     right
  213.           Causes text to be flush right, with a ragged left margin.
  214.  
  215.     center
  216.           Causes text to be centered between the left and right margins
  217.           (this can be affected by list indentation, blockquotes, and a
  218.           few other tags).
  219.  
  220.     justify
  221.           Causes text to be fully justified (both right and left margins
  222.           smooth).
  223.  
  224.     indent
  225.           Causes text to be indented from the left margin.
  226.  
  227.    * Limited font selection.  Using the <big> and <small> tags, HTML 3.0
  228.      gives the user some control over font size without the overhead of
  229.      a stylesheet.*Note Style Sheets::
  230.  
  231.    * Subscripts and superscripts.  The <sub> and <sup> tags allow you to
  232.      have limited math markup anywhere in your document.
  233.  
  234.    * More powerful inlined images.  With the <fig> tag, you now have
  235.      much more control over inlined image formatting.  Chief among them
  236.      in usefulness for Emacs-w3 users is the ability to put the old
  237.      <img> tag's alt text before the </fig> element, and the ability to
  238.      include markup in it.  For example: `<fig ismap
  239.      src="fancyhrule.gif"><hr></fig>', so that the user with inlined
  240.      images turned off will get the same effect.
  241.  
  242.    * Better control over list formatting.  For odered (<OL>) lists, you
  243.      can now specify the type of numbering to use.  With the new 'type'
  244.      attribute, you can specify arabic, alphabetical, or roman
  245.      numbering, in either upper or lowercase.  Also, the optional
  246.      'start' attribute lets you specify the starting list item number.
  247.  
  248.      For unordered lists (<UL>), you can specify that the browser
  249.      should not insert any bullets on list items by using the new PLAIN
  250.      attribute.
  251.  
  252.    * More form widgets.  New input types include RANGE, FILE, images,
  253.      and named submit and reset buttons.
  254.  
  255.    * LINK support.  LINKs allow the author to specify the relevance
  256.      between documents easily.  This makes it possible to point to
  257.      dictionaries, glossaries, abd indices, or to specify the author of
  258.      a document.
  259.  
  260.    * Annotations.  Can have <footnote> and <margin> notes that show up
  261.      as footnotes at the bottom of a document.
  262.  
  263.    * Notes and admonishments.  The NOTE tag provides a way to specify a
  264.      warning or other standard information.  Shows appropriate bitmap if
  265.      possible.  Similar to warning dialogs in Windows/Macintosh.
  266.      Syntax is `<note role=simple|note|caution|warning>A note for the
  267.      user</note>'.  The default role is 'simple'.
  268.  
  269.    * Infinitely nested lists, and use of paragraphs and headers within
  270.      lists.
  271.  
  272.                                ---------
  273.  
  274.                              Netscape-HTML
  275.  
  276.                                ---------
  277.  
  278.    I hate to say it, but I broke down and actually included some of the
  279. netscape extensions into Emacs-w3.
  280.  
  281. <font>...</font>
  282.      You can change the font size.  Valid values range from 0-7. The
  283.      default font size is 3. The value given can optionally have a '+'
  284.      or '-' character in front of it to specify that it is relative to
  285.      the document basefont.
  286.  
  287. <center>...</center>
  288.      This ugly, ill-thought-out alternative to the HTML 3.0 align
  289.      attribute on headers and paragraphs was included for
  290.      compatibility, and as an example of how not to do things.
  291.  
  292. <isindex>
  293.      The isindex tag can now take a prompt attribute, to get rid of the
  294.      default 'This is a searchable index' label.
  295.  
  296. <hr width=xx align=xx>
  297.      You can now control the width of a horizontal rule, in relation to
  298.      the total window size.  The WIDTH attribute specifies how wide the
  299.      rule should be, as a percentage of the window width.
  300.  
  301.      The ALIGN attribute specifies where the horizontal rule is placed.
  302.      Valid values are left, right, center, and indent.
  303.  
  304. <body background=URL bgcolor=RGB TEXT=RGB LINK=RGB VLINK=RGB>
  305.      You can specify various colors and formatting issues on a document
  306.      wide basis.  This is done with various attributes on the BODY tag.
  307.      Stylesheets are really a better way to do this, and are
  308.      recommended.  This is just for compatibility.  *Note Style Sheets::
  309.     BACKGROUND=URL
  310.           Specifies a graphic to tile in the background of the
  311.           document.  This only works in XEmacs 19.12.
  312.  
  313.     BGCOLOR=COLOR
  314.           Specifies the background of the document, as a color instead
  315.           of a graphic.  COLOR should be either an RGB specification
  316.           (like `"#FF00BB"'), or a logical color name (like
  317.           `"PaleGoldenrod"').  The logical color names supported are
  318.           system dependent.
  319.  
  320.     TEXT=COLOR
  321.           Specifies the color of text on the page.  COLOR should be
  322.           either an RGB specification (like `"#FF00BB"'), or a logical
  323.           color name (like `"PaleGoldenrod"').  The logical color names
  324.           supported are system dependent.
  325.  
  326.     LINK=COLOR
  327.           Specifies the color of hypertext links on the page.  COLOR
  328.           should be either an RGB specification (like `"#FF00BB"'), or
  329.           a logical color name (like `"PaleGoldenrod"').  The logical
  330.           color names supported are system dependent.
  331.  
  332.     VLINK=COLOR
  333.           Specifies the color of hypertext links that have been visited
  334.           already.  COLOR should be either an RGB specification (like
  335.           `"#FF00BB"'), or a logical color name (like
  336.           `"PaleGoldenrod"').  The logical color names supported are
  337.           system dependent.
  338.  
  339.                                ---------
  340.  
  341.                                 Extras
  342.  
  343.                                ---------
  344.  
  345.    There are several different markup elements that are not officially
  346. part of HTML or HTML 3.0 that Emacs-w3 supports.  These are either
  347. items that were dropped from HTML 3.0 after I had implemented them, or
  348. experimental parts of HTML that should not be counted as "official" or
  349. long lived.
  350.    * More <HR> improvements.  You can add text into a horizontal rule by
  351.      using the LABEL and TEXTALIGN attributes.
  352.           <hr label="testing" textalign="right">
  353.           yields
  354.           ----------------------------------------------------------testing-
  355.           
  356.           <hr label="testing" textalign="center">
  357.           yields
  358.           -----------------------------testing------------------------------
  359.           
  360.           <hr label="testing" textalign="left">
  361.           yields
  362.           -Testing----------------------------------------------------------
  363.  
  364.    * Entity definitions within documents.  This allows the author of an
  365.      HTML page to define per-document macros.  Syntax is <!ENTITY TAG
  366.      "Expansion of Tag">, which replaces all occurences of &TAG; with
  367.      Expansion of Tag.
  368.  
  369.    * Embedding of arbitrary objects into an HTML document.  With the
  370.      <embed> tag, you can insert any document, or image.  The most
  371.      entertaining use of this is with embedding MPEG movies into an
  372.      emacs buffer.  This requires Lucid Emacs 19.10, or XEmacs 19.11,
  373.      as well as a slightly patched version of mpeg_play 2.0 (the patch
  374.      is available from ftp.cs.indiana.edu:/pub/elisp/w3/mpeg_patch).
  375.  
  376.    * FLAME support.  For truly interesting dynamic documents.  This is
  377.      replaced with a random quote from Mr. Angry (see `M-x flame' for a
  378.      sample).
  379.  
  380.    * The top ten tags that did not make it into netscape.  These tags
  381.      were posted to the newsgroup comp.infosystems.www.misc by Laura
  382.      Lemay (lemay@netcom.com).  Much thanks to her for the humor.
  383.     <wired>...</wired>
  384.           Renders the enclosed text in a suitably ugly font/color
  385.           combination.  If no default has been set up by the user, this
  386.           is the default font, with red text on a yellow background.
  387.  
  388.     <roach>...</roach>
  389.           When selected, the enclosed text runs and hides under the
  390.           nearest window.  OR, giggles a lot and demands nachos,
  391.           depending on your definition of "roach." (the formal
  392.           definition, of course, to be determined by the Official
  393.           Honorary Internet Standards Committee For Moving Really
  394.           Slowly.)
  395.  
  396.     <kill_sgml>
  397.           Should anyone foolish enough to think that HTML is still SGML
  398.           and try and run a netscape-html document through an SGML
  399.           editor, processor, or other tool, this tag causes an
  400.           immediate core dump, erases anything on your disk with "DTD"
  401.           in the name, and emails a randomly-selected insult to Tim
  402.           Pierce.
  403.  
  404.           Emacs-w3 just inserts a rude comment.
  405.  
  406.     <pinhead>
  407.           Inserts "zippyisms" into the enclosed text.  Perfect for
  408.           those professional documents.  This is sure to be a favorite
  409.           of mine!
  410.  
  411.     <secret>...</secret>
  412.           In order to read the enclosed text, you have to have secret
  413.           spy decoder glasses (available direct from Mcom for a
  414.           reasonable fee).  You can also read it by holding your
  415.           computer in front of a full moon during the autumn solstice.
  416.  
  417.           In Emacs-w3, this displays the text using rot13 encoding.
  418.  
  419.     <hype>
  420.           Causes Marc Andreesen to magically appear and grant you an
  421.           interview (whether you want one or not).  Please use this tag
  422.           sparingly.
  423.  
  424.     <peek>....</peek>
  425.     <poke>...</poke>
  426.           So you want more control over screen layout in HTML?  Well,
  427.           here ya go.
  428.  
  429.           Actually, <peek> could almost be considered useful.  The
  430.           VARIABLE attribute can be used to insert the value of an
  431.           emacs variable into the current document.  Things like
  432.           'Welcome to my page, <peek variable=user-mail-address>' can
  433.           be useful in freaking people out.
  434.  
  435.     <yogsothoth>
  436.           Summons the elder gods to suck away your immortal soul.  Or
  437.           Bill Gates, if the elder gods are busy.  Unpredictable (but
  438.           amusing) results occur when the <YOGSOTHOTH> and <HYPE> tags
  439.           are used in close proximity.
  440.  
  441.     <blink>...</blink>
  442.           Causes the enclosed text to .... ooops that one made it in.
  443.  
  444. 
  445. File: w3.info,  Node: Supported Protocols,  Prev: Markup Languages Supported,  Up: Introduction
  446.  
  447. Supported Protocols
  448. *******************
  449.  
  450.    Emacs-w3 supports the following protocols
  451. Usenet News
  452.      Can either display an entire newsgroup or specific articles by
  453.      Message-ID: header.  This supports a unix-style .newsrc file, so
  454.      the user does not see articles they have read using another
  455.      newsreader, but due to how news URLs work, Emacs-w3 cannot update
  456.      the users .newsrc after they have read news.
  457.  
  458.      To be more in line with the other URL schemes, Emacs-w3 lets you
  459.      specify the hostname and port of an NNTP server in a news URL.
  460.      URLs of the form news://hostname:port/messageID work, but will not
  461.      work in the majority of other browsers (yet).
  462.  
  463. HTTP
  464.      Supports both the HTTP/0.9 and HTTP/1.0 protocols.  Fully
  465.      MIME-compliant with regards to HTTP/1.0. *Note HTTP/1.0 Support::
  466.  
  467. Gopher
  468.      Support for all gopher types, include CSO queries.
  469.  
  470. Gopher+
  471.      Support for Gopher+ retrievals. Support for converting ASK blocks
  472.      into HTML 3.0 FORMS and submitting them back to the server.
  473.  
  474. FTP
  475.      FTP is handled by either ange-ftp or efs, the choice is up to the
  476.      individual user.
  477.  
  478. Local files
  479.      Local files are handled, and MIME content-types are derived from
  480.      the file extensions.
  481.  
  482. Telnet
  483.      Telnet is handled by running the Emacs Lisp function `telnet', or
  484.      spawning an xterm running telnet.
  485.  
  486. TN3270
  487.      TN3270 is handled by running a tn3270 program in an Emacs buffer,
  488.      or spawning an xterm running tn3270.
  489.  
  490. Mailto
  491.      Causes a mail message to be started to a specific address.
  492.  
  493. mailserver
  494.      A more powerful version of mailto, which allows the author to
  495.      specify the subject and body text of the mail message.  This type
  496.      of link is never fully executed without user confirmation, because
  497.      it is possible to insert insulting or threatening (and possibly
  498.      illegal) data into the message.  The mail message is displayed,
  499.      and the user must type 'yes' to send it.
  500.  
  501. X-exec
  502.      A URL can cause a local executable to be run, and its output
  503.      interpreted as if it had come from an HTTP server.  This is very
  504.      useful, but is still an experimental protocol, hence the X- prefix.
  505.  
  506. SSL
  507.      SSL requires a set of patches to the Emacs C code and SSLRef 2.0,
  508.      or an external program to run in a subprocess (similar to the
  509.      `tcp.el' package that comes with GNUS.  *Note SSL::
  510.  
  511. Secure HTTP
  512.      Work is in progress to add support for the Secure HTTP
  513.      specification from Enterprise Information Technologies.  The
  514.      specification for SHTTP can be found on EIT's web server at
  515.      http://www.commerce.net/information/standards/drafts/shttp.txt.
  516.  
  517. 
  518. File: w3.info,  Node: Setting Up,  Next: Retrieving Emacs-w3,  Prev: Introduction,  Up: Top
  519.  
  520. Setting Up
  521. **********
  522.  
  523.    This section of the manual deals with getting, compiling, and
  524. configuring Emacs-w3.
  525.  
  526. * Menu:
  527.  
  528. * Retrieving Emacs-w3::         Retrieving Emacs-w3 via anonymous ftp
  529. * Compiling Emacs-w3::          Compiling Emacs-w3 and its associated files
  530. * Basic Setup::                 Basic setup that everyone needs to do
  531. * Firewalls::                   How to set Emacs-w3 up to use a particular
  532.                                 firewall setup.
  533. * Proxy Gateways::              Using a proxy server
  534.  
  535. 
  536. File: w3.info,  Node: Retrieving Emacs-w3,  Next: Compiling Emacs-w3,  Prev: Setting Up,  Up: Setting Up
  537.  
  538. Retrieving Emacs-w3
  539. ===================
  540.  
  541.    If using Lucid Emacs 19.9 or later, skip to the section on starting
  542. Emacs-w3.  Emacs-w3 comes standard with all versions of Lucid Emacs from
  543. 19.9 onwards.
  544.  
  545.    Three files are required when first installing Emacs-w3.  All of them
  546. can be found via anonymous ftp to ftp.cs.indiana.edu:/pub/elisp/w3.  The
  547. files are `w3-XXX.tar.gz', where XXX is the version number of Emacs-w3
  548. being retrieved, `icons.tar.gz', which contains approximately 50 small
  549. icons that Emacs-w3 requires, and are available to HTML authors.  The
  550. `extras.tar.gz' file contains ange-ftp, html-mode, and nntp.
  551.  
  552.    After retrieving the files, unpack them with the following commands:
  553. `zcat w3-XXX.tar.gz | tar xvvf -', `zcat icons.tar.gz | tar xvvf -',
  554. and `zcat extras.tar.gz | tar xvvf -'.  This unpacks the distribution
  555. into three subdirectories `w3', `icons', and `extras'.  To compile and
  556. install all the packages in the extras directory, please see the
  557. comments at the top of each lisp file.
  558.  
  559. 
  560. File: w3.info,  Node: Compiling Emacs-w3,  Next: Basic Setup,  Prev: Retrieving Emacs-w3,  Up: Setting Up
  561.  
  562. Compiling Emacs-w3
  563. ==================
  564.  
  565.    To install Emacs-w3, go into the `w3' subdirectory and edit the
  566. `Makefile'.  These variables might need to be changed:
  567. `EMACS'
  568.      This variable controls what version of Emacs is used to compile the
  569.      programs.  It should be the full path to the Emacs executable on
  570.      the system.  The default is to use GNU Emacs (`emacs').
  571.  
  572. `LISPDIR'
  573.      This variable controls where the lisp code is copied to when it is
  574.      installed (with `make install').  This is usually the users
  575.      personal lisp code directory (I prefer `~/lisp').  The value is run
  576.      through "expand-file-name" and then added to the load-path.
  577.  
  578. `DOTEMACS'
  579.      This variable points to the Emacs customization file, usually
  580.      `~/.emacs'.
  581.  
  582. `INFODIR'
  583.      This variable points to the local info directory (usually
  584.      `/usr/local/info').  This can be any valid directory, as long as it
  585.      is in `Info-default-directory-list' so that info-mode can find it.
  586.  
  587. `MAKEINFO'
  588.      This variables controls how the info files are built.  Possible
  589.      values are `makeinfo' or `emacs -batch -q -f batch-texinfo-format'.
  590. Once the `Makefile' has been modified, several different targets can be
  591. built.
  592. `make w3'
  593.      This compiles all the .el files into the much faster .elc files.
  594.      If Jamie Zawinski's optimizing byte compiler (standard in GNU
  595.      Emacs 19 and Lucid Emacs) is used, then a few compilation warnings
  596.      are displayed (not many hopefully).  These can be safely ignored
  597.      as long as everything finishes compiling.  This is the default
  598.      target for `make' with no arguments.
  599.  
  600. `make install'
  601.      Compiles all the .el files and copies .el and .elc files into the
  602.      directory specified by `LISPDIR'.
  603.  
  604. `make emacs'
  605.      Modifies the file specified by `DOTEMACS'.  A statement modifying
  606.      the load-path variable and several autoload statements are added
  607.      to the end of the file.
  608.  
  609. `make all'
  610.      Compiles and installs the .el files, and also modify/create the
  611.      `DOTEMACS' file.
  612.  
  613. `make w3.info'
  614.      Creates the Emacs-readable info files.  The info files are created
  615.      in the directory specified by `INFODIR'.  The makefile variable
  616.      `MAKEINFO' determines how the info file is built.
  617.  
  618. `make w3.dvi'
  619.      Creates the printable documentation, using tex and texindex to
  620.      properly generate the indices.  A `w3.dvi' file is left in the
  621.      current directory.
  622.  
  623. 
  624. File: w3.info,  Node: Basic Setup,  Next: Firewalls,  Prev: Compiling Emacs-w3,  Up: Setting Up
  625.  
  626. Basic Setup
  627. ===========
  628.  
  629.    There are a few variables that almost all people need to change.
  630.  
  631. `url-bad-port-list'
  632.      List of ports to warn the user about connecting to.  Defaults to
  633.      just the mail and NNTP ports so a malicious HTML author cannot
  634.      spoof mail or news to other people.
  635.  
  636. `url-be-asynchronous'
  637.      Controls whether document retrievals over HTTP should be done in
  638.      the background.  This allows emacs to keep working in other
  639.      windows while large downloads occur.  Defaults to `nil'.  This
  640.      variable is buffer-local, so use `setq-default' after loading
  641.      Emacs-w3 to globally modify it, or set it in your `~/.emacs' file.
  642.  
  643. `url-confirmation-func'
  644.      What function to use for asking yes or no functions.  Possible
  645.      values are `'yes-or-no-p' or `'y-or-n-p', or any function that
  646.      takes a single argument (the prompt), and returns `t' only if a
  647.      positive answer is gotten.  Defaults to `'yes-or-no-p'.
  648.  
  649. `w3-default-action'
  650.      A lisp symbol specifying what action to take for files with
  651.      extensions that are not in the `mm-mime-extensions' assoc list.
  652.      This is useful in case Emacs-w3 ever run across files with weird
  653.      extensions (.foo, .README, .READMEFIRST, etc.).  In most
  654.      circumstances, this should not be required anymore.
  655.  
  656.      Possible values: any lisp symbol.  Should be a function that takes
  657.      no arguments.  The return value does not matter, it is ignored.
  658.      Some examples are `'w3-prepare-buffer' or `'indented-text-mode'.
  659.  
  660. `w3-default-homepage'
  661.      The url to open at startup.  It can be any valid URL.  This
  662.      defaults to the environment variable WWW_HOME if it is not set it
  663.      in the users `.emacs' file. If WWW_HOME is undefined, then it
  664.      defaults to the hypertext documentation for Emacs-w3 at Indiana
  665.      University.
  666.  
  667. `w3-delay-image-loads'
  668.      Controls the loading of inlined images.  If non-`nil', images are
  669.      not loaded.  For slow network connections, this is usually set to
  670.      `t'.  Defaults to `nil'.
  671.  
  672. `w3-delimit-emphasis'
  673.      Whether to use characters at the start and end of each bold/italic
  674.      region.  Types of characters are specified in
  675.      `w3-style-tags-assoc'.  `w3-style-tags-assoc' is an assoc list of
  676.      style names, the `cdr' of each is a cons cell.  The `car' of this
  677.      cell is the string to insert at the beginning of the emphasis, and
  678.      the `cdr' is the string to insert at the end of the emphasis.  The
  679.      default value is a good example.
  680.  
  681.           (
  682.            (b       "*"  . "*")
  683.            (address "*"  . "*")
  684.            (byline  "_"  . "_")
  685.            (cite    "_"  . "_")
  686.            (cmd     "*"  . "*")
  687.            (dfn     "*"  . "*")
  688.            (em      "~"  . "~")
  689.            (i       "~"  . "~")
  690.            (q       "\"" . "\"")
  691.            (removed ""   . "")
  692.            (s       ""   . "")
  693.            (strong  "*"  . "*")
  694.            (sub     ""   . "")
  695.            (sup     ""   . "")
  696.            (u       "_"  . "_")
  697.           )
  698.  
  699. `w3-delimit-links'
  700.      Controls how hypertext links are displayed.  If this variable is
  701.      `eq' to `'linkname', then the link NAME or ID of the link is
  702.      inserted after the link text.  If `nil', then nothing is done.  If
  703.      it is non-`nil' and not `eq' to `'linkname', then [[ & ]] is
  704.      inserted around the entire text of the link.  Is initially set to
  705.      be `t' iff in normal Emacs, `nil' if in Epoch or Lucid Emacs,
  706.      since links should be in different colors/fonts.
  707.  
  708. `url-global-history-file'
  709.      The global history file used by both Mosaic/X and Emacs-w3.  This
  710.      file contains a list of all the URLs that have been visited.  This
  711.      file is parsed at startup and used to provide URL completion.
  712.      Emacs-w3 can read and write Mosaic/X or Netscape/X style history
  713.      files, or use its own internal format (faster).  The file type is
  714.      determined automatically, or prompted for if the file does not
  715.      exist.
  716.  
  717. `w3-hotlist-file'
  718.      Hotlist filename.  This should be the name of a file that is
  719.      stored in NCSA's Mosaic/X or Netscape's format.  It is used to
  720.      keep a listing of commonly accessed URL's without having to go
  721.      through 20 levels of menus to get to them.
  722.  
  723. `w3-personal-annotation-directory'
  724.      The directory where Emacs-w3 looks for personal annotations.  This
  725.      is a directory that should hold the personal annotations stored in
  726.      a Mosaic-compatible format.
  727.      (ncsa-mosaic-personal-annotation-log-format-1)
  728.  
  729. `url-pgp/pem-entity'
  730.      The name by which the user is known to PGP and/or PEM entities.
  731.      If this not set when `w3-do-setup' is run, it defaults to
  732.      `(user-real-login-name)'@`(system-name)', which can often be wrong.
  733.  
  734. `url-personal-mail-address'
  735.      Your full email address.  This is what is sent to HTTP/1.0 servers
  736.      as the FROM field.  If this is not set when `w3-do-setup' is run,
  737.      then it defaults to the value of `url-pgp/pem-entity'.
  738.  
  739. `w3-right-border'
  740.      Amount of space to leave on right margin of WWW buffers.  This
  741.      amount is subtracted from `(window-width)' for each new WWW buffer
  742.      and used as the new `fill-column'.
  743.  
  744. `w3-track-mouse'
  745.      Controls whether to track the mouse and message the url under the
  746.      mouse.  If this is non-`nil', then a description of the hypertext
  747.      area under the mouse is shown in the minibuffer.  This shows what
  748.      type of link (inlined image, form entry area, delayed image,
  749.      delayed MPEG, or hypertext reference) is under the cursor, and the
  750.      destination.  This only works in Emacs-19, Lucid Emacs, or XEmacs.
  751.  
  752. `w3-use-forms-index'
  753.      Non-`nil' means translate <ISINDEX> tags into a hypertext form.  A
  754.      single text entry box is drawn where the ISINDEX tag appears.  If
  755.      `t', the isindex handling is the same as Mosaic for X.
  756.  
  757. `url-use-hypertext-gopher'
  758.      Controls how gopher documents are retrieved.  If non-`nil', the
  759.      gopher pages are converted into HTML and parsed just like any other
  760.      page.  If `nil', the requests are passed off to the `gopher.el'
  761.      package by Scott Snyder.  Using the `gopher.el' package loses the
  762.      gopher+ support, and inlined searching.
  763.  
  764. `url-wais-gateway-port'
  765.      The port # of the WAIS gateway to pass all wais:// requests to.
  766.      *Note Native WAIS Support::
  767.  
  768. `url-wais-gateway-server'
  769.      The machine name where the WAIS gateway lives.  *Note Native WAIS
  770.      Support::
  771.  
  772. `url-xterm-command'
  773.      Command used to start a windowed shell, similar to an xterm.  This
  774.      string is passed through `format', and should expect four strings:
  775.      the title of the window, the program name to execute, and the
  776.      server and port number.  The default is for xterm, which is very
  777.      unix-centric, but is the most common case.
  778.  
  779. 
  780. File: w3.info,  Node: Firewalls,  Next: Proxy Gateways,  Prev: Basic Setup,  Up: Setting Up
  781.  
  782. Firewalls
  783. =========
  784.  
  785.    There are several different reasons why you may need to use the
  786. gateway support in Emacs-w3.
  787.   1. You are behind a firewall.  This is usually the case at large
  788.      corporations with paranoid system-administrators.
  789.  
  790.   2. You are using TERM (1) for slip-like access to the internet.
  791.  
  792.      NOTE: Emacs 19.22 has patches to enable native TERM networking, to
  793.      enable it, #define TERM in the appropriate s/*.h file for your
  794.      operating system, then change the SYSTEM_LIBS define to include
  795.      the `termnet' library that comes with the latest versions of TERM.
  796.  
  797.   3. For some reason your version of Emacs can't resolve hostnames.
  798.      This happens quite often on Sun workstations and some ultrix
  799.      machines.  Some C libraries do not include the hostname resolver
  800.      routines in their static libraries.  If Emacs was linked
  801.      statically, this means it won't be able to get to any machines off
  802.      your local net.  This is characterized by being able to reach
  803.      someplace with a raw ip number, but not its hostname
  804.      (http://129.79.254.191/ works, but http://www.cs.indiana.edu/
  805.      doesn't).
  806.  
  807.      If for some reason your system administrator will not recompile
  808.      Emacs with the `-lresolv' library or dynamic linking, you need to
  809.      act as if you were behind a firewall.  Another alternative is to
  810.      set the variable `url-broken-resolution' - this will use the
  811.      support in ange-ftp or EFS to use `nslookup' in a subprocess to do
  812.      all hostname resolving.  See the variables `efs-nslookup-bprogram',
  813.      `efs-nslookup-on-connect', and `efs-nslookup-threshold' if you are
  814.      using EFS, or `ange-ftp-nslookup-program' if you are using
  815.      Ange-Ftp.
  816.  
  817.   4. You are running Lucid Emacs 19.x and Solaris 2.x (SunOS 5.x).  For
  818.      some reason, network processes under Solaris and Lucid Emacs never
  819.      get a status of `exit' or `closed'.  This causes retrieval of HTTP
  820.      and gopher pages to hang indefinitely, with Emacs chewing up large
  821.      amounts of your CPU time.
  822.  
  823.      NOTE: You do not need to use gateways anymore for this problem.
  824.  
  825.      With the release of Lucid Emacs 19.10, this problem is fixed if you
  826.      #define FIX_SOLARIS_W3_BUG somewhere in your config.h or s/*.h
  827.      configuration file.  This will be in the stock 19.11 release of
  828.      XEmacs
  829.  
  830.  
  831.    Emacs-w3 has support for using the gateway mechanism for certain
  832. domains, and directly connecting to others.  To use this, you must
  833. change the value of `url-gateway-local-host-regexp'.  This should be a
  834. regular expression (2) that matches local hosts that do not require the
  835. use of a gateway.  If `nil', then all connections are made through the
  836. gateway.
  837.  
  838.    Emacs-w3 supports several methods of getting around gateways.  The
  839. variable `url-gateway-method' controls which of these methods is used.
  840. This variable can have several values (use these as symbol names, not
  841. strings):
  842. "program"
  843.      Run a program in a subprocess to connect to remote hosts (examples
  844.      are itelnet(3), an expect(4) script, etc.).
  845.  
  846. "host"
  847.      This allows you to log into another local computer that has access
  848.      to the internet, and run a telnet-like program from there.
  849.  
  850. "tcp"
  851.      Masanobu UMEDA umerin@mse.kyutech.ac.jp has written a very nice
  852.      replacement for the standard networking in Emacs.  This does
  853.      basically the same thing that a method of `program' does, but is
  854.      slightly more transparent to the user.
  855.  
  856. "native"
  857.      This means that Emacs-w3 should use the builtin networking code of
  858.      Emacs.  This should be used only if there is no firewall, or
  859.      someone at your site has already hacked the Emacs source to get
  860.      around your firewall.  Two of these need a bit more explanation
  861. than that: If you are running a program in a subprocess to emulate a
  862. network connection, you need to set a few extra variables.  The variable
  863. `url-gateway-telnet-program' should point to an executable that accepts
  864. a hostname and port # as its arguments, and passes standard input to
  865. the remote host.  This can be either the full path to the executable or
  866. just the basename.  The variable `url-gateway-telnet-ready-regexp'
  867. controls how long Emacs-w3 should wait after spawning the subprocess to
  868. start sending to its standard input.  This gets around a bug where
  869. telnet would miss the beginning of requests becausse it did not buffer
  870. its input before opening a connection.  This should be a regular
  871. expression to watch for that signifies the end of the setup of
  872. `url-gateway-telnet-program'.  The default should work fine for telnet.
  873.  
  874.    If you are using the `host'-based gatway method, things get a bit
  875. more complicated.  This is basically my attempt to do some of the basic
  876. stuff of expect within elisp.  First off, set the variable
  877. `url-gateway-host' to be the name of your gateway machine.
  878.  
  879.    The variable `url-gateway-connect-program' controls how the host is
  880. reached.  The easiest way is to have a program that does not require a
  881. username and password to allow you to login.  The most common of these
  882. is the "rsh" command.
  883.  
  884.    If you do not have rsh, then things get very ugly.  First, set the
  885. variable `url-gateway-program-interactive' to non-`nil'.  Then you need
  886. to define the variables `url-gateway-host-username' and
  887. `url-gateway-host-password' to be the username and password necessary
  888. to log into the gateway machine.  The regular expressions in the
  889. variables `url-gateway-handholding-login-regexp' and
  890. `url-gateway-handholding-password-regexp' should match the login and
  891. password prompts on the gateway system respectively.  For example:
  892.  
  893.      (setq url-gateway-connect-program "telnet"
  894.            url-gateway-host-program "telnet"
  895.            url-gateway-program-interactive t
  896.            url-gateway-host-username "wmperry"
  897.            url-gateway-host-password "yeahrightkeepdreaming"
  898.            url-gateway-host "moose.cs.indiana.edu"
  899.            url-gateway-host-program-ready-regexp "Escape character is .*"
  900.            url-gateway-handholding-login-regexp "ogin:"
  901.            url-gateway-handholding-password-regexp "ord:")
  902.  
  903.    This should take care of you logging into the remote system.  The
  904. variable `url-gateway-host-prompt-pattern' should contain a regular
  905. expression that matches the shell prompt on the remote machine.  This
  906. should appear no where in the login banner/setup, or things could get
  907. very confused.
  908.  
  909.    Now you are ready to actually get off of your local network!  The
  910. variable `url-gateway-host-program-ready-regexp' should contain a
  911. regular expression that matches the end of the setup of
  912. `url-gateway-host-program' when it tries to make a connection to an
  913. off-firewall machine.  (Basically the same as
  914. `url-gateway-telnet-ready-regexp'.
  915.  
  916.    Now you should be all set up to get outside your local network.  If
  917. none of this makes sense, its probably my fault.  Please check with your
  918. network administrators to see if they have a program that does most of
  919. this for you already, since somebody somewhere at your company has
  920. probably been through something similar to this before, and would be
  921. much more helpful/knowledgeable about your local setup than I would be.
  922. But feel free to mail me as a last resort.
  923.  
  924.    ---------- Footnotes ----------
  925.  
  926.    (1)  TERM is a user-level protocol for emulating IP over a serial
  927. line.  More information is available at
  928. sunsite.unc.edu:/pub/Linux/apps/comm/term
  929.  
  930.    (2)  Please see the full Emacs distribution for a description of
  931. regular expressions
  932.  
  933.    (3)  Itelnet is a standard name for a telnet executable that is
  934. capable of escaping the firewall.  Check with your system
  935. administrators to see if you have anything similar
  936.  
  937.    (4)  Expect is a scripting language that allows you to control
  938. interactive programs (like telnet) very easily.  It is available from
  939. gatekeeper.dec.com:/pub/GNU/expect-3.24.0.tar.gz
  940.  
  941. 
  942. File: w3.info,  Node: Proxy Gateways,  Next: Basic Usage,  Prev: Firewalls,  Up: Setting Up
  943.  
  944. Proxy Gateways
  945. ==============
  946.  
  947.    In late January 1993, Kevin Altis and Lou Montulli proposed and
  948. implemented a new proxy service.  This service requires the use of
  949. environment variables to specify a gateway server/port # to send
  950. protocol requests to.  Each protocol (http, wais, gopher, ftp, etc.)
  951. can have a different gateway server.  The environment variables are
  952. PROTOCOL_proxy, where PROTOCOL is one of gopher, file, http, ftp, or
  953. wais.
  954.  
  955.    The main thing to understand about the proxy gateway is that instead
  956. of a partial URL being sent to the HTTP server, which is what we do
  957. today when a client talks directly to an HTTP server, a client must
  958. send a full URL (http://..., gopher://..., ftp://...) to the proxy
  959. gateway server, the rest of the HTTP message is the same. For gopher
  960. and ftp, the proxy gateway server returns the data encapsulated as a
  961. MIME content type to the client like a normal HTTP message. HTTP MIME
  962. content types are returned for all URL requests, regardless of the
  963. protocol type of the URL. FTP directories, Gopher directories, etc. are
  964. returned as text/html.
  965.  
  966. 
  967. File: w3.info,  Node: Basic Usage,  Prev: Proxy Gateways,  Up: Top
  968.  
  969. Basic Usage
  970. ***********
  971.  
  972.    Emacs-w3 is similar to the Info package all Emacs users hold near
  973. and dear to their hearts (*Note Info: (info)Top, for a description of
  974. Info).  Basically, `space' and `backspace' control scrolling, and
  975. `return' or `mouse2' follows a hypertext link.  The `f' and `b' keys
  976. maneuver around the various links on the page.
  977.  
  978.    NOTE: To enter data into a form entry area, you must select it using
  979. `return' or `mouse2' just like a hypertext link.
  980.  
  981.    On non-graphic terminals (vt100, DOS, etc.), or with a graphics
  982. terminal and old versions (18.xx) of Emacs, hypertext links are
  983. surrounded by '[[' and ']]' by default.  On a graphics terminal with
  984. newer versions of Emacs (epoch, lucid, or FSF 19), the links are in
  985. bold print.  *Note Controlling Formatting:: for information on how to
  986. change this, or for help on getting the highlighting to work on graphics
  987. terminals.
  988.  
  989.    There are approximately 50 keys bound to special Emacs-w3 functions.
  990. The basic rule of thumb regarding keybindings in Emacs-w3 is that a
  991. lowercase key takes an action on the current document, and an uppercase
  992. key takes an action on the document pointed to by the hypertext link
  993. under the cursor.
  994.  
  995.    There are several areas that the keybindings fall into: movement,
  996. information, action, and miscellaneous.
  997.  
  998. * Menu:
  999.  
  1000. * Movement::        Moving around in a Emacs-w3 buffer
  1001. * Information::        Getting information about the Emacs-w3 document you
  1002.             are viewing, and/or links within that document.
  1003. * Action::        Taking actions in a Emacs-w3 buffer (following links,
  1004.             printing, etc.)
  1005. * Miscellaneous::    Miscellaneous keybindings
  1006.  
  1007. 
  1008. File: w3.info,  Node: Movement,  Next: Information,  Prev: Basic Usage,  Up: Basic Usage
  1009.  
  1010. Movement
  1011. ========
  1012.  
  1013. `SPC'
  1014.      Scroll downward in the buffer.  With prefix arg, scroll down that
  1015.      many screenfuls.
  1016.  
  1017. `DEL'
  1018.      Scroll upward in the buffer.  With prefix arg, scroll up that many
  1019.      screenfuls.
  1020.  
  1021. `<, M-x w3-start-of-document'
  1022.      Go to start of document
  1023.  
  1024. `>, M-x w3-end-of-document'
  1025.      Go to end of document
  1026.  
  1027. `Shift-TAB, b, M-x w3-back-link'
  1028.      Attempts to move backward one link area in the current document.
  1029.      Signals an error if no previous links are found.
  1030.  
  1031. `H, M-x w3-show-hotlist'
  1032.      A hypertext listing of the items in the hotlist is generated on
  1033.      the fly, and the links can be followed normally.
  1034.  
  1035. `h, M-x w3-use-hotlist'
  1036.      Possibly go to a link in the hotlist.  A new buffer is created for
  1037.      the new document.
  1038.  
  1039. `m, M-x w3-complete-link'
  1040.      Choose a link from the current buffer and follow it.  A
  1041.      completing-read is done on all the links, so `space' and `TAB' can
  1042.      be used for completion.
  1043.  
  1044. `TAB, f, n, M-x w3-forward-link'
  1045.      Attempts to move forward one link area in the current document.
  1046.      Signals an error if no more links are found.
  1047.  
  1048. 
  1049. File: w3.info,  Node: Information,  Next: Action,  Prev: Movement,  Up: Basic Usage
  1050.  
  1051. Information
  1052. ===========
  1053.  
  1054.    These functions relate information about one or more links on the
  1055. current document.
  1056. `v, M-x url-view-url'
  1057.      This shows the URL of the current document in the minibuffer.
  1058.  
  1059. `V, M-x w3-view-this-url'
  1060.      This shows the URL of the hypertext link under point in the
  1061.      minibuffer.  If there is not a hypertext link under point, then it
  1062.      shows the type of form entry area under point.  If there is no
  1063.      form entry area under point, then it shows the inlined image's URL
  1064.      that is under point, if any.
  1065.  
  1066. `i, M-x w3-document-information'
  1067.      Shows miscellaneous information about the currently displayed
  1068.      document.  This includes the URL, the last modified date, MIME
  1069.      headers, the HTTP response code, and the LINK tags found in the
  1070.      document (that describe relations between this and other
  1071.      documents).
  1072.  
  1073. `I, M-x w3-document-information-this-url'
  1074.      Shows information about the URL at point.  If it is an HTTP link,
  1075.      the HTTP/1.0 HEAD method is used to retrieve information, and this
  1076.      is what is displayed.  If it is a file or an ftp link, information
  1077.      about the file is shown, including whether it is a directory, who
  1078.      owns it, last access, modified, and changed times, the size, and
  1079.      the file type that Emacs-w3 thinks it is (text/plain, image/gif,
  1080.      etc).
  1081.  
  1082. `s, M-x w3-source-document'
  1083.      This shows the HTML source of the current document in a separate
  1084.      buffer.  The `buffer-name' is based on the document's URL.
  1085.  
  1086. `S, M-x w3-source-document-at-point'
  1087.      Shows the HTML source of the hypertext link under point in a
  1088.      separate buffer.  The `buffer-name' is based on the document's URL.
  1089.  
  1090. `k, C-k, M-x w3-save-url'
  1091.      This stores the current document's URL in the kill ring, and also
  1092.      in the current window-system's clipboard, if possible.
  1093.  
  1094. `K, M-x w3-save-this-url'
  1095.      Stores the URL of the document under point in the kill ring, and
  1096.      also in the current window-system's clipboard, if possible.
  1097.  
  1098.